package com.witmore.neutron.ai.mcp.server.trading.service;

/**
 * 异动报告服务接口
 * 
 * @author 豆子高
 * @since 2025-01-27
 */
public interface AbnormalReportService {

    /**
     * 异步生成异动报告
     * 
     * @param recordId 异动记录ID
     * @param userId 用户ID
     * @param stockCode 股票代码
     * @param stockName 股票名称
     */
    void generateAbnormalReportAsync(Long recordId, Long userId, String stockCode, String stockName);

    /**
     * 生成PDF格式的异动报告
     * 
     * @param recordId 异动记录ID
     * @param userId 用户ID
     * @param stockCode 股票代码
     * @param stockName 股票名称
     * @return 报告文件URL
     */
    String generatePdfReport(Long recordId, Long userId, String stockCode, String stockName);

    /**
     * 生成Excel格式的异动报告
     * 
     * @param recordId 异动记录ID
     * @param userId 用户ID
     * @param stockCode 股票代码
     * @param stockName 股票名称
     * @return 报告文件URL
     */
    String generateExcelReport(Long recordId, Long userId, String stockCode, String stockName);
}
